home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk185 / textra / textra.doc < prev    next >
Text File  |  1995-03-19  |  28KB  |  638 lines

  1.  
  2.    This document describes TEXTRA, a very user-friendly text editor.  So
  3. user-friendly, I hope, that you could use it without reading a manual.
  4. Good learning philosophy: play with it.
  5.    
  6. TEXTRA makes no claim at being the most powerful editor around, or the
  7. fastest, smallest or any-OTHER-est.  One of the easiest, that's
  8. the goal.  And free.
  9.  
  10.    TEXTRA is FreeWare and freely distributable.  I request, however,
  11. that this README file accompany the executable if passed around.
  12.  
  13.    If you are using TEXTRA to read this file, just point the mouse
  14. at the arrow in the lower-right corner, and hold the left mouse button
  15. down.  You'll know when to let up.
  16.  
  17.    TEXTRA was written in JForth Professional, which I recommend highly.
  18.  
  19.                                             Thanx,  Mike Haas
  20.  
  21.  
  22. 26-Apr-89 v1.01 executable size 60148
  23. 29-May-89 v1.02   "    "    "   60864
  24. 22-Jul-89 v1.03   "    "    "   61080
  25. 21-Oct-89 v1.04   "    "    "   65208
  26. 05-Jan-90 v1.05   "    "    "   69836
  27. 18-Feb-90 v1.06   "    "    "   69400
  28. 18-Apr-90 v1.07   "    "    "   70520
  29. 06-Jun-90 v1.08   "    "    "   71544
  30. 15-Dec-90 v1.09   "    "    "   79404
  31. ---------------------------------------------------------------------------
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.               T A B L E     O F     C O N T E N T S
  43.              ---------------------------------------
  44.  
  45. 1.  INVOKING TEXTRA
  46.     1.1  Invoking from Workbench or CLI
  47.     1.2  Optional filename argument usage
  48.     1.3  Shift-Double-clicking with "project"-type icons
  49.     1.4  TEXTRA as the Default Tool for "Project"-type icons
  50. 2.  THE TEXTRA CURSOR
  51.     2.1  Cursor appearance
  52.     2.2  Positioning the cursor with the keyboard arrow keys
  53.     2.3  Positioning the cursor with the mouse
  54.     2.4  Quickly finding the cursor (function key F3)
  55. 3.  ENTERING TEXT INTO THE DOCUMENT
  56.     3.1  Inserting text at the cursor location
  57.     3.2  The RETURN key
  58.          3.2.1  The "Auto-Indent" mode
  59.     3.3  The BACKSPACE key
  60.          3.3.1  The "Auto-BackSpace" mode
  61.     3.4  The DEL key
  62.     3.5  The TAB key
  63.          3.5.1 Settable TAB Width
  64.     3.6  The control-key filter and defeat feature (Function key F2)
  65.     3.7  The HELP key
  66. 4.  SELECTING A RANGE OF TEXT
  67.     4.1  Using the mouse to select a range of characters
  68.     4.2  Selecting text by double and triple clicking
  69.     4.3  Operations on selected ranges
  70.     4.4  Selecting more than the visible screen
  71.     4.5  Quickly finding the selected range (function key F3)
  72.     4.6  Extending a select range by SHIFT-clicking
  73. 5.  VIEWING PAGES
  74.     5.1  The vertical scroll arrow gadgets
  75.     5.2  The vertical scroll thumb gadget
  76.     5.3  Scrolling the page with the keyboard arrow keys
  77.     5.4  Keys that PAGE-up or PAGE-down
  78. 6.  TEXTRA WINDOWS
  79.     6.1  Limitations
  80.     6.2  The title bar
  81.     6.3  The close gadget
  82.     6.4  The sizing gadget
  83.     6.5  The Window-Size-Toggle feature (Function key F1)
  84.     6.6  The 'Present Next Window' feature (Function key F6)
  85. 7.  TEXTRA MENUS
  86.     7.1  Accessing the menus
  87.     7.2  The "Project" menu
  88.          7.2.1  Open A File...
  89.          7.2.2  Open By Name...
  90.          7.2.3  New File
  91.          7.2.4  Revert To Saved
  92.          7.2.5  Save File
  93.          7.2.6  Save File As...
  94.          7.2.7  Save All Files
  95.          7.2.8  Close File
  96.          7.2.9  About TEXTRA...
  97.          7.2.8  Close File
  98.          7.2.9  Print File
  99.          7.2.10 Printing Preferences...
  100.          7.2.11 About TEXTRA...
  101.          7.2.12 Quit
  102.     7.3  The "Windows" menu
  103.          7.3.1  Dynamically-changing items
  104.          7.3.2  Additional information
  105.     7.4  The "Edit" menu
  106.          7.4.1  Cut
  107.          7.4.2  Copy
  108.          7.4.3  Paste
  109.          7.4.4  Find
  110.                 7.4.4.1  String...
  111.                          7.4.4.1.1 Wrap-around search option
  112.                 7.4.4.2  Next Occurence
  113.          7.4.5  Replace
  114.                 7.4.5.1  String...
  115.                 7.4.5.2  Next Occurence
  116.          7.4.6  Case
  117.                 7.4.6.1  lower
  118.                 7.4.6.2  UPPER
  119.                 7.4.6.3  Capitalize
  120.          7.4.7  Go to Line...
  121.          7.4.8  Editing Preferences...
  122.     7.5  The "Utilities" menu
  123.          7.5.1  File Protections...
  124.          7.5.2  Help on Keyboard...
  125. 8.  TEXTRA GENERAL INFORMATION
  126.     8.1  TEXTRA's use of Path and File names
  127.     8.2  String Gadget Shortcuts
  128.     8.3  TEXTRA String Gadgets and the RETURN key
  129.     8.4  TEXTRA Requesters
  130.     8.5  TEXTRA Preferences File
  131.     8.6  TEXTRA Keyboard Summary
  132.  
  133. ---------------------------------------------------------------------------
  134.  
  135.  
  136. 1. INVOKING TEXTRA
  137.  
  138. 1.1 TEXTRA, if double-clicked from WorkBench, will ask you to
  139. select a filename soon after opening its first window.  TEXTRA
  140. may be launched from CLI or SHELL with multiple filenames
  141. as follows:
  142.  
  143.     1> TEXTRA <filename1> <filename2> ... <filenameX>
  144.  
  145.             OR
  146.  
  147.     1> RUN TEXTRA <filename1> <filename2> ... <filenameX>
  148.  
  149. 1.2 If the optional filenames are not given, TEXTRA will ask you to
  150. select one, as if double-clicked.  Select "CANCEL" if you do not
  151. want to edit an existing file; the default name "Untitled" will
  152. be assigned.
  153.  
  154. 1.3 From Workbench, "Project" icons that are also selected when TEXTRA
  155. is "SHIFT-Double-Clicked" will each be opened in their respective window.
  156.  
  157. 1.4 A "Project" icon that has TEXTRA specified in its "Default Tool"
  158. field will invoke TEXTRA, when double-clicked, and be opened in its
  159. own window.
  160.  
  161. ---------------------------------------------------------------------------
  162.  
  163.  
  164. 2. THE TEXTRA CURSOR
  165.  
  166. 2.1 The current cursor location (where text will be inserted) is
  167. represented by a thin line, of a different color than either text
  168. or background.  If placed inside a text string, the cursor is
  169. always BETWEEN two characters, showing clearly the sections that will
  170. "spread apart" if something is typed into the window.
  171.  
  172. 2.2 The cursor may be moved with the "arrow" keys on the keyboard; a
  173. SHIFT-left-arrow or SHIFT-right-arrow will move the cursor to the
  174. beginning or end of the current line, respectively.
  175.  
  176. 2.3 The cursor may also be positioned by clicking the LEFT MOUSE
  177. BUTTON, while the mouse cursor is over a part of the windows text area.
  178.  
  179. 2.4 The display will move to the cursor location when the F3 key
  180. is pressed.
  181.  
  182. ---------------------------------------------------------------------------
  183.  
  184.  
  185. 3. ENTERING TEXT INTO THE DOCUMENT
  186.  
  187. 3.1 As keys are typed at the keyboard, they are entered in the file
  188. at the current cursor location, and the cursor is advanced by one.
  189.  
  190. 3.2 The RETURN key inserts a new line, and moves the cursor there.
  191.  
  192. 3.2.1 If the Auto-Indent mode is enabled (see section 7.4.8), the
  193. cursor will advance to the same column as the 1st non-blank character
  194. on the line above when the RETURN key is pressed.
  195.  
  196. 3.3 The BACKSPACE deletes the character to the immediate left of the
  197. cursor and backs the cursor up one column.  If the cursor is at the
  198. leftmost column, the preceeding newline is removed and the cursor
  199. moves up one line.
  200.  
  201. 3.3.1 The Auto-BackSpace mode (section 7.4.8), if enabled, comes into
  202. play when the cursor rests on the 1st non-blank character of a line.
  203. Then, the line is "backed-up" by whatever it takes to line up with
  204. the beginning of the text on the line above.  If the previous line
  205. does not start to the left of the cursor line, the alignment is made
  206. to the next line above that does.
  207.  
  208. 3.4 The DELETE key removes the character to the immediate right of the
  209. cursor.  If the cursor is at the end of a line, the newline is removed
  210. and the next line moves up to merge with the current.
  211.  
  212. 3.5 The TAB key advances the cursor to the next column that is an
  213. even multiple of the TAB width value (section 3.5.1).
  214.  
  215. 3.5.1 Settable TAB WIDTH (section 7.4.8) provides a way of changing
  216. the default TAB width (8).  A string requester is presented, with
  217. the currently installed size.  Maximum width accepted is 16.  The
  218. setting applies to all windows.
  219.  
  220. 3.6 Normally, TEXTRA will not allow control characters into the
  221. window, permitting only visible or white-space characters.  This
  222. feature can be temporarily defeated, for 1 character, by pressing F2.
  223. Following F2, the next character will be accepted into the window
  224. unfiltered.
  225.  
  226. 3.7 The HELP key will display an informational requestor, displaying
  227. the functions that are available from the keyboard.  These fall into
  228. 2 categories; those that are also available from menus and those
  229. that aren't.
  230.  
  231. ---------------------------------------------------------------------------
  232.  
  233.  
  234. 4. SELECTING A RANGE OF TEXT
  235.  
  236. 4.1 It is possible to mark a series of characters for the next
  237. operation by "dragging" with the mouse.  The sequence is:
  238.  
  239.   a. Position the mouse over the 1st character of the desired series.
  240.   b. Press the left mouse button and, while holding it down, move the
  241.      mouse to the last character of the series (even if it is on another
  242.      line).  Note that the characters between that clicked-on and wherever
  243.      you move the mouse become "highlighted" (selected).
  244.   c. Release the left mouse button when the desired range of characters
  245.      is selected.
  246.  
  247. 4.2 Any series of non-white characters will become selected if the
  248. LEFT MOUSE BUTTON is double-clicked while the mouse cursor is
  249. positioned over them.  If the LEFT MOUSE BUTTON is triple-clicked,
  250. the entire line that the cursor is pointing to is selected.
  251.  
  252. 4.3 When a range of text is selected, a subsequent operation will
  253. affect the entire selected area.  For example, if a key is typed while
  254. a range is selected, the range will be cut from the file, replaced by
  255. that key.  Other examples are the BACKSPACE and DEL keys, which both
  256. act to simply delete any selected area.  Certain items under the EDIT
  257. menu, described later, also operate on any current range.
  258.  
  259. 4.4 If, while selecting text, the mouse is moved near the bottom or top
  260. of the window, available text in the appropriate direction will scroll
  261. into view, becoming selected in the process.  Therefore, a select range
  262. can extend past the visible limits of the window.
  263.  
  264. 4.5 The display will move to the beginning of any currently-selected
  265. range when the F3 key is pressed.
  266.  
  267. 4.6 A select range may be established or size changed by holding
  268. down the SHIFT key when clicking in the window.  If the click occurs
  269. outside the current select range, the range is extended to there.
  270. If inside, the end-point of the select range is adjusted to the
  271. click-point.
  272.  
  273. ---------------------------------------------------------------------------
  274.  
  275.  
  276. 5. VIEWING PAGES
  277.  
  278. 5.1 The easiest method for moving through the file is to use the vertical
  279. scroll bar on the right side of the window.  Single clicks of the left
  280. mouse button on the arrows at either end move the document vertically,
  281. one line at a time.  Holding the left button down on either yields a
  282. continuous scroll.
  283.  
  284. 5.2 The "thumb" in the middle of the scroll bar not only indicates the
  285. visible-page-area relative to the total-file-size (by it's height),
  286. but also the position within the file (by its vertical positioning).
  287. It can also be "selected" with the left mouse button and moved as
  288. a "coarse adjust".  The area immediately above and below the "thumb"
  289. may be clicked with the left button as a "page-scroll" mechanism.
  290.  
  291. 5.3 Another method by which text may be scrolled into view is to move
  292. the cursor, via the keyboard "arrow" keys, to either the top or bottom
  293. of the visible window.  Attempts to move the cursor "off the window"
  294. will cause text in that direction to scroll.
  295.  
  296. 5.4 Function keys F4 and F5 will PAGE the display down and up,
  297. respectively.  The Shift-arrow-key combinations will also PAGE
  298. the display in the appropriate direction AND position the cursor
  299. to the middle of the new page.
  300.  
  301. ---------------------------------------------------------------------------
  302.  
  303.  
  304. 6. TEXTRA WINDOWS
  305.  
  306. 6.1 TEXTRA allows any number of windows, limited by the amount of
  307. memory in your computer (most limiting is probably the amount of
  308. available CHIP ram).  Textra lines can be up to 255 characters long,
  309. number of lines limited by your total available memory (entire file
  310. is kept in ram, FAST is grabbed first).
  311.  
  312. 6.2 The title of each TEXTRA window is set to the full-pathname
  313. of the file that was read in (or created).  This is also the name
  314. of the file that will be written during a SAVE operation (unless
  315. the "SAVE AS..." menu option is chosen, section 7.2.6).  If the
  316. file has been modified since last saved, the filename will be
  317. preceeded by a '*'.
  318.  
  319. 6.3 Each window includes a standard Intuition close gadget, which
  320. performs the same action as the "CLOSE FILE" menu option.  See the
  321. discussion on "CLOSE FILE" (section 7.2.8) for more information.
  322.  
  323. 6.4 The "sizing" gadget in the lower-right hand corner of each window
  324. may be used to adjust the dimensions of that window, up to the
  325. full-screen limitations of the Workbench.
  326.  
  327. 6.5 Function key F1 may be used as a "window-size-toggle" between
  328. default size (when F1 was first hit) and full-screen (as per current
  329. screen resolution settings).  This is particularly
  330. useful when Workbench is in 400 line interlace.
  331.  
  332. (NOTE: if F1 is used to expand the screen, and the size gadget is
  333.        then clicked without actually changing size, the default-size 
  334.        becomes equal to the full-screen-size.  This will make F1
  335.        non-functional until the size gadget is used to actually
  336.        change window size.  To avoid this, don't click on the
  337.        sizing gadget when the window is full-size.  Use F1 to
  338.        get back to normal size).
  339.  
  340. 6.6 Function key F6 will cycle through and present each file loaded
  341. by the editor.
  342.  
  343. ---------------------------------------------------------------------------
  344.  
  345.  
  346. 7. TEXTRA MENUS
  347.  
  348. 7.1 4 menus are available and present themselves when the RIGHT
  349. MENU BUTTON is depressed and held.  Some menu items may also
  350. be activated by simultaneously pressing the RIGHT AMIGA key
  351. and the one that is specified in the menu item text.  A list of
  352. such menu "key equivalents" presents itself, as part of the HELP
  353. key facility (section 3.7).
  354.  
  355. 7.2 The "Project" Menu
  356.  
  357. 7.2.1 OPEN A FILE... opens a new window with a full file-selector
  358. requester and buttons that allow quick access to the top 6 disk
  359. devices (like DF0:).  The PARENT button changes the current directory
  360. to the level above the one being displayed.  The KEYBOARD button
  361. presents the user with a string requester into which a file or
  362. directory specification may be typed.  The CANCEL button exits the
  363. requester with no other action while the OK button enters the file
  364. or directory selected in the list box (the same as CANCEL if nothing
  365. is selected).  Double-clicking one of the names performs the same
  366. action as the OK button.
  367.  
  368. 7.2.2 OPEN BY NAME... opens a new window, then presents a string
  369. requester for specifying the filename from the keyboard, bypassing
  370. the directory scan for the list of names (which can take time on
  371. large directories, especially on floppy drives).  Note that the
  372. current directory of the requester is that of the spawning window.
  373. If a pathname is typed into this requester, the "OPEN A FILE" selector
  374. requester is opened, presenting a list of the files in that directory.
  375.  
  376. 7.2.3 NEW FILE opens a window without specifying a filename; the
  377. default name "Untitled" is assigned, at the directory level of
  378. the spawning window.
  379.  
  380. 7.2.4 REVERT TO SAVED causes the read-in version of the selected
  381. file to be discarded, replaced by the version that was last-saved
  382. to disk.  A verification requester is presented to make sure this
  383. is not done accidently.
  384.  
  385. 7.2.5 SAVE FILE causes the currently-selected file to be written to
  386. disk, if modified.  If the file has not been changed (no '*' before
  387. the title), this menu item is disabled.
  388.  
  389. 7.2.6 SAVE FILE AS... allows saving the currently selected file under
  390. a different name.  After this operation, the title bar will contain
  391. the new name, and it will have been created on disk.  If the
  392. specified file already exists, the user is warned and given a
  393. chance to abort.  The "USE LIST" button will present a full
  394. file-requester through which an existing file may be selected with
  395. the mouse.  This requester is very similar in operation to the
  396. "OPEN FILE..." requester; all buttons work the same, except the
  397. OK button will overwrite the selected file (as does double-clicking
  398. a filename).
  399.  
  400. 7.2.7 SAVE ALL FILES causes all files that have been modified and not
  401. saved to be written to disk.  If there are no modified files, this
  402. menu item is disabled.
  403.  
  404. 7.2.8 CLOSE FILE will check if the file has been modified but not
  405. saved and warn the user if so.  Note that closing TEXTRA's last window
  406. will cause it to exit; a requester will notify you if you are closing
  407. the last window and give you the chance to abort.
  408.  
  409. 7.2.9 PRINT FILE prints (to the printer.device) the currently selected
  410. window using the current preference settings (section 7.2.10).  While
  411. a print job is in progress, other windows may be edited, but not printed.
  412. Print jobs may be cancelled at any time.
  413.  
  414. 7.2.10 PRINTING PREFERENCES... presents a dialog to allow the user to
  415. specify whether or not to print 1). a onle-line page header at the top
  416. of each page noting the date, filename and page number and 2). preceed
  417. each line with its sequential number in the file.  Note that TEXTRA also
  418. observes the system 'Preferences' settings for left & right margin,
  419. characters-per-line, and lines-per-page (use your system 'Preferences'
  420. tool to set these).  The USE button causes the currently displayed
  421. settings to go into effect.  The USE+SAVE button does the USE function,
  422. and also saves the current settings in the Textra Preferences file (sec-
  423. tion 8.5).  The CANCEL button causes any currently displayed settings
  424. (that have been changed), to be discarded.  If the PRINT PREFERENCES
  425. requester is active, this menu item is disabled from other windows.
  426.  
  427. 7.2.11 ABOUT TEXTRA is self-explanatory.
  428.  
  429. 7.2.12 QUIT will exit TEXTRA, closing all files in the process.  All
  430. files that have been modified but not saved will issue a notification
  431. requester, providing the opportunity to save at that time.
  432.  
  433. 7.3 The "Windows" Menu
  434.  
  435. 7.3.1 One item exists in the "WINDOWS" menu for each open file, the
  436. menu item text being the same as the title bar for the associated
  437. window.  Selecting an item makes it the current window, if not
  438. already.
  439.  
  440. 7.3.2 Additionally, the text includes the "*" character before the
  441. filename if the file has been modified since last written to disk.
  442. A checkmark preceeds the item representing the current file.
  443.  
  444. 7.4 The "Edit" Menu
  445.  
  446. 7.4.1 CUT removes the selected range of characters from the 
  447. currently-selected file, but saves them in the TEXTRA clip area
  448. (TEXTRA does not interface with the standard Amiga Clipboard
  449. Device...future versions may do so).  The previous contents of
  450. the TEXTRA clip area are lost.  If there is no select range,
  451. this menu item is disabled.
  452.  
  453. 7.4.2 COPY moves the selected range of characters of the 
  454. currently-selected file to the TEXTRA clip area, but does not
  455. remove them from the file.  The previous contents of the TEXTRA
  456. clip area are lost.  If there is no select range, this menu
  457. item is disabled.
  458.  
  459. 7.4.3 PASTE inserts whatever is in the TEXTRA clip area into the
  460. currently-selected file, at the current cursor location.  If a select
  461. range is active in this file, it is deleted before the insertion takes
  462. place.  There is no effect on the contents of the TEXTRA clip area.
  463. It nothing has been placed into the TEXTRA clip area (via CUT or COPY),
  464. this menu item is disabled.
  465.  
  466. 7.4.4 FIND presents a sub-menu with 2 choices:
  467.  
  468. 7.4.4.1 STRING... presents a requester prompting for the string
  469. to search for, ignoring character case.  The string gadget will, as
  470. a default, contain the previous string searched for IN THAT WINDOW
  471. (empty if none).  However, if a range of characters is selected that
  472. is ALL ON ONE LINE, it will supercede any previously-searched-for
  473. string as the default for the string gadget.  The search begins just
  474. past the current cursor location or selected range of characters.
  475.  
  476. 7.4.4.1.1 WRAP... On the FIND STRING requester is a checkbox that
  477. allows you to enable "wrap-around" search.  Normally, if the search
  478. string is not found, TEXTRA terminates the search at the end of the
  479. document.  With the "wrap" box checked, the search will continue from
  480. line 1, and end when either the text is found, or the starting line
  481. is reached.  This mode also applies to the "FIND NEXT OCCURENCE" menu
  482. item (section 7.4.4.2).
  483.  
  484. 7.4.4.2 NEXT OCCURENCE conducts another case-insensitive search
  485. for the same text string that had previously been searched for.
  486. If no search had yet been conducted the "STRING..." requester is presented.
  487.  
  488. 7.4.5 REPLACE presents a sub-menu with 2 choices:
  489.  
  490. 7.4.5.1 STRING... presents a double-string-requester, prompting for
  491. 1). the string to conduct a case-insensitive search for, and 2). a
  492. string to replace the first with, when found.  The RETURN key will
  493. toggle the selected string gadget.  The user may optionally 1). replace
  494. all instances of the found string (with the "ALL" button), 2). replace
  495. just the next one found (via the "ONCE" button), or 3). abort (via
  496. "CANCEL").  The search begins just past the current cursor location
  497. or selected range of characters.
  498.  
  499. 7.4.5.2 NEXT OCCURENCE conducts another "REPLACE" operation, using the
  500. same strings that were used last time.  If none exist, the "STRING..."
  501. requester is presented.
  502.  
  503. 7.4.6 CASE presents a sub-menu with 3 choices:
  504.  
  505. 7.4.6.1 LOWER exhibits 2 behaviors depending on whether an area
  506. is selected or not.  If there is, the entire selected area is converted
  507. to lower case.  If not, the next word after the cursor is searched for
  508. and converted to lower case if found. 
  509.  
  510. 7.4.6.2 UPPER exhibits 2 behaviors depending on whether an area
  511. is selected or not.  If there is, the entire selected area is converted
  512. to upper case.  If not, the next word after the cursor is searched for
  513. and converted to upper case if found. 
  514.  
  515. 7.4.6.3 CAPITALIZE exhibits 2 behaviors depending on whether an area
  516. is selected or not.  If there is, each word in the selected area is
  517. located and capitalized.  If not, the next word after the cursor is
  518. located and capitalized. 
  519.  
  520. 7.4.7 GO TO LINE... presents a string requester prompting for the
  521. desired line number, with the initial string gadget contents being
  522. equal to the current cursor line (or the beginning of any selected
  523. range).  First line of file is considered line 1.
  524.  
  525. 7.4.8 EDITING PREFERENCES... presents a requester allowing the selection
  526. of modes and settings, specifically, the "Auto-Indent" mode (section
  527. 3.2.1), the "Auto-BackSpace" mode (section 3.3.1) and the TAB WIDTH
  528. (section 3.5.1).  The USE button causes the currently displayed
  529. settings to go into effect.  The USE+SAVE button does the USE function,
  530. and also saves the current settings in the Textra Preferences file (sec-
  531. tion 8.5).  The CANCEL button causes any currently displayed settings
  532. (that have been changed), to be discarded.  If the PRINT PREFERENCES
  533. requester is active, this menu item is disabled from other windows.
  534.  
  535. 7.5  The "Utilities" Menu
  536.  
  537. 7.5.1  FILE PROTECTIONS... provides the ability to set the 6 relevant
  538. file protection bits that are stored and processed by AmigaDOS.  These
  539. include Deletable, Executable, Writable, Readable, Archived and Script
  540. (particularly handy when writing AmigaDOS scripts).  The SAVE button
  541. causes the currently displayed settings to become active.  The CANCEL
  542. button is self-explanatory.
  543.  
  544. 7.5.2  HELP ON KEYBOARD... performs the same action as the HELP key (sec-
  545. tion 3.7).
  546.  
  547. ---------------------------------------------------------------------------
  548.  
  549.  
  550. 8. TEXTRA GENERAL INFORMATION
  551.  
  552. 8.1 TEXTRA always fully expands a specified file or directory name
  553. and uses that form to again find the file, if necessary.  For example,
  554. you may have typed in "DF1:MyFile" as the filename, but the window
  555. title will substitute the name of the volume, possibly "MyDisk:MyFile".
  556. This is almost always desirable, because if TEXTRA saved "DF1:", you
  557. might unknowingly save it to the wrong disk, just because you switched
  558. the disk in that drive.  TEXTRA will ask you specifically for the same
  559. name.
  560.    The only situation you should be aware of is WHEN YOU HAVE TWO
  561. DISKS OF THE SAME NAME in your system.  In this case, AmigaDOS can
  562. sometimes choose the wrong disk when TEXTRA passes the full-pathname
  563. to it.
  564.   In the above example, we could save it to the wrong disk if the disk
  565. in DF0: is also named "MyDisk:" (a backup, perhaps???).  This is not
  566. caused by TEXTRA, but can happen anytime in AmigaDOS that you use the
  567. full-pathname to specify a file.
  568.  
  569. 8.2 Intuition provides two String Gadget shortcuts that can be
  570. useful to the TEXTRA user.  TEXTRA string gadgets that provide
  571. a default text string when they appear will revert back to this
  572. string whenever "Right Amiga-Q" is pressed.  The "Right Amiga-X"
  573. combination will clear any displayed string.
  574.  
  575. 8.3 For all string gadgets but one, the RETURN key will perform
  576. the same action  as the "OK" button.  The one exception is the
  577. "REPLACE" double-string requester, where the RETURN key toggles
  578. between the two string gadgets.
  579.  
  580. 8.4 TEXTRA Requesters are attached to (drawn in) the window that they
  581. have been spawned from.  The advantage is that multiple requesters
  582. are possible...you can select and work in another file even if
  583. the previous window is waiting for you to answer a question.  Every
  584. window can, in fact, have an open requester.
  585.   Note that, if your window is too small, you may have to expand
  586. its size to inter-operate with a given requester.  Unfortunately,
  587. since the Intuition requester mechanism locks out my console events
  588. from that window, I can't process the F1 key, and you have to do
  589. this with the mouse.
  590.   (Intuition should give the application a looksee at the keys before
  591. using them in a string gadget, throwing them away or whatever.  The
  592. application could reply with a boolean, whether it wants the requester
  593. to use it or not.  This could even default to NO_BOOLEAN if not specified
  594. previously by the caller as a requester mode.  Maybe a REQ_KEY_VERIFY
  595. event. Oh well, let's re-design Intuition another time).
  596.  
  597. 8.5 TEXTRA maintains certain user-settable parameters in the file
  598. "devs:Textra.prefs".  If your system disk is of the floppy variety,
  599. you may therefore be asked to insert this disk if you elect to save it.
  600. Normally, TEXTRA looks for this file only once, at startup.
  601.  
  602. 8.6 Keyboard Summary:
  603.  
  604.     F1 - Window Size Toggle (6.4)
  605.     F2 - Keyboard Filter Defeat (3.6)
  606.     F3 - Page to Cursor or Beginning of Select Range (4.5)
  607.     F4 - Display next page (5.4)
  608.     F5 - Display previous page (5.4)
  609.     F6 - Present next file (6.6)
  610.  
  611.     Help - Displays Function Key Assignments for F1 - F6 (3.7)
  612.     
  613.     Shift-Left-arrow  - Cursor to beginning of current line (2.2)
  614.     Shift-Right-arrow - Cursor to end of current line (2.2)
  615.     Shift-Up-arrow    - Display previous page, cursor to middle (5.4)
  616.     Shift-Down-arrow  - Display next page, cursor to middle (5.4)
  617.  
  618.     Right-Amiga-O - Open existing file via file requester (7.2.1)
  619.     Right-Amiga-P - Open existing file by typing its name (7.2.2)
  620.     Right-Amiga-[ - Open a new file (7.2.3)
  621.     Right-Amiga-S - Save the current file (7.2.5)
  622.     Right-Amiga-X - Cut selected text, save in clip area (7.4.1)
  623.     Right-Amiga-C - Copy selected text into clip area (7.4.2)
  624.     Right-Amiga-V - Paste clip area into file (7.4.3)
  625.     Right-Amiga-F - Find string in any case (7.4.4.1)
  626.     Right-Amiga-N - Find the next occurance of same string (7.4.4.2)
  627.     Right-Amiga-R - Replace string with another (7.4.5.1)
  628.     Right-Amiga-T - Find & replace same string again (7.4.5.2)
  629.     Right-Amiga-L - Set text or next word to lower case (7.4.6.1)
  630.     Right-Amiga-U - Set text or next word to upper case (7.4.6.2)
  631.     Right-Amiga-K - Capitalize words or next word (7.4.6.3)
  632.     Right-Amiga-G - Go to a specific line (7.4.7)
  633.     
  634.     Requester control...
  635.     
  636.     Right-Amiga-X - Clear text in string requester (8.2)
  637.     Right-Amiga-Q - Restore original string requester text (8.2)
  638.